package cn.shengchao.examstar.shared.acl.ai;

import cn.shengchao.examstar.shared.acl.ai.dto.KnowledgeEvaluationResult;
import java.io.IOException;

/**
 * AI知识点评估服务接口
 * 定义在共享内核中，作为业务模块和AI模块之间的契约
 */
public interface AIKnowledgeEvaluationService {
    
    /**
     * 评估知识点掌握度
     *
     * @param userId 用户ID
     * @param exerciseData 做题数据JSON
     * @return 知识点评估结果
     * @throws IOException 如果调用AI服务时发生错误
     */
    KnowledgeEvaluationResult evaluateKnowledgeMastery(Long userId, String exerciseData) throws IOException;
} 